Skip to content

Conversation

@xpcmdshell
Copy link
Owner

Summary

  • Recommend SubprocessExecutor as default instead of InProcessExecutor
  • Fix internal API usage patterns to use Session facade methods
  • Add missing documentation for CLI, Session API, and integrations
  • Fix factual errors and add features list to README

Changes

New Documentation

  • docs/cli-reference.md - MCP server flags and Store CLI commands
  • docs/session-api.md - Complete Session method reference
  • docs/integrations.md - Framework integration patterns

Updated Documentation

  • docs/executors.md - Reordered to recommend SubprocessExecutor, added decision guide
  • docs/getting-started.md - Changed examples to use SubprocessExecutor
  • docs/dependencies.md - Fixed outdated storage.get_deps_store() references
  • docs/production.md - Fixed internal API usage
  • docs/skills.md - Use Session facade instead of internal stores
  • docs/storage.md - Updated migration section, fixed executor example
  • docs/ARCHITECTURE.md - Added quick reference, updated decision tree
  • examples/minimal/README.md - Fixed outdated tools.call() syntax

README Improvements

  • Fixed "Three Namespaces" to "Four Namespaces" (added deps)
  • Added Features section with key capabilities
  • Reorganized documentation links into categories

Meta

  • Added branch policy to AGENTS.md (main is protected)

- Reorder executors.md to recommend SubprocessExecutor first with decision guide
- Update all examples from InProcessExecutor to SubprocessExecutor
- Replace internal storage.get_*() calls with Session facade APIs
- Fix outdated tools.call() syntax in minimal example
- Add warnings to InProcessExecutor section about risks
- Add branch policy to AGENTS.md (main is protected)

Files updated:
- README.md, docs/getting-started.md, docs/executors.md
- docs/dependencies.md, docs/production.md, docs/skills.md
- docs/storage.md, docs/ARCHITECTURE.md
- examples/minimal/README.md, AGENTS.md
New documentation:
- docs/cli-reference.md: MCP server flags and Store CLI commands
- docs/session-api.md: Complete Session method reference
- docs/integrations.md: Framework integration patterns

Updated:
- README.md: Reorganized documentation links, added new docs
@xpcmdshell xpcmdshell merged commit d977dba into main Jan 2, 2026
2 checks passed
@xpcmdshell xpcmdshell deleted the docs/improve-documentation-accuracy branch January 2, 2026 19:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants